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Important Notice 

1. All design and engineering decisions with regard to the integration of PicoP® Display 
Engine (PDE) module inside the customer’s products are the responsibility of the 
customer. This includes all decisions related to the application of PDE, including any 
beam redirection and/or manipulation provided external to the PDE module or any 
decisions that may affect the laser classification of customer’s products. 

2. This PicoP® Display Engine (PDE) Programmer’s Guide is confidential and proprietary 
information of Microvision and the information contained herein may not be shared 
with any third party (individual or entity) without express written permission from 
Microvision. This document and the information contained herein is Microvision 
Confidential Information subject to the terms and conditions of the Non-Disclosure 
Agreement between Microvision and customer. 
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1. Scope 

This document details the command and control interface of Microvision’s PicoP® Display Engine (PDE). 
The PDE is intended to be used by customers wishing to embed a small and thin full color laser projector inside 
their product. The PDE comes with PicoP® Software Development Kits (SDKs), which facilitate third-party 
Application Software development for the PicoP Display Engine (PDE). 

The PicoP SDKs contain the following: 

• Operating System specific software libraries for interfacing with the PDE 

• Application Programming Interfaces (APIs) 

• Sample Applications 

• Documentation 


The PicoP SDKs support 3 API types: 

• C Function API for the Windows operating system and Linux operating system 

• Java Class API for Android ™ operating system 

• Objective-C Class API for iPhone OS (Requires external iPhone OS Authentication Hardware) 

Other languages in the Windows and Linux operating systems, such as Java, C#, or VB.Net can be supported 
through wrappers or controls built on top of the C Function API. 

This document defines all applicable functions and commands supported by the PDE Application 
Programming Interface (API). The supported functions are described in programming language independent 
pseudo-code. For language specific information, please refer to the appropriate PDE Software Development Kit 
(SDK) documentation. 

The information contained in this document is provided for guidance purposes only and is subject to 
change. 
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1.1. Reference 

DAO 127245 - PicoP® Windows SDK Getting Started Guide 

DA0127249 - PicoP® Windows SDK Programmer's Reference Guide 

DA0127254 - PicoP® Linux SDK Getting Started Guide 

DAO 127256 - PicoP® Linux SDK Programmer's Reference Guide 

DAO 130542 - PicoP Mac OS X SDK Getting Started Guide 

DAO 130544 - PicoP Mac OS X SDK Programmer's Reference Guide 

DAO 127268 - PicoP® Android SDK Getting Started Guide 

DA0127270 - PicoP® Android SDK Programmer's Reference Guide 

DAO 128984 - PicoP Angstrom Linux SDK Getting Started Guide 

DAO 128986 - PicoP Angstrom Linux SDK Programmer's Reference Guide 

DAO 127261 - PicoP® iPhone OS SDK Getting Started Guide 

DAO 127263 - PicoP® iPhone OS SDK Programmer's Reference Guide 

DAO 129161 - PicoP® (jC SDK Getting Started Guide 

DAO 129163 - PicoP® pC SDK Programmer's Reference Guide 

DC0125698 - PDE Specification & Interface Control Document 


MICROVISION 
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2. Communication Interface 

The host device can communicate with the PDE either through USB or UART interface. To enable the 
USB interface, the USBJVBUS input pin must be active (driven high) on the PDE electrical interface. When 
USBJVBUS pin is inactive, the default UART interface may be used. 

At the USB or UART level, the host device communicates with PDE module using Micro vision’s 
proprietary PicoP Command Protocol (PPCP). These low level PPCP commands are abstracted by the PicoP 
Software Development Kit (SDK) Application Programming Interface (API). The PPCP packets are generated 
by the SDK Libraries as requested by the application SW thru API function/method calls. 



C API 
Java API 
Objective-C API 


OS Services API 


Hardware Interface 


PPCP Communication 
with PicoP 
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3. API Functions 

3.1. API Version Information 

The SDK allows the host to retrieve the version of the API. 

3.1.1. GetLibrarylnfo (librarylnfo) 

This function is used to retrieve the version and capability information of the SDK Library. 


Parameter 

Description 

librarylnfo [OUT] 

Library info structure containing major version, minor version and 
capability flags of the SDK Library 


3.2. Connection Management Functions 

The connection Management functions are used to connect to the PDE and configure the communications 
interface. 

3.2.1. OpenLibrary (libraryHandle) 

Opens the interface library and allocates resources necessary for operation. Returns a handle to the library 
to be used for opening a connection to the PDE. The OpenLibraryO function must be called first in an 
application. 


Parameter 

Description 

libraryHandle [OUT] 

A handle to the opened SDK Library 


3.2.2. CloseLibrary (libraryHandle) 

Closes the library, releases all resources and closes all open connections. Should be called last upon exiting 
the application. 


Parameter 

Description 

libraryHandle [IN] 

The handle to the SDK Library to be closed 


3.2.3. OpenConnection ( connectionType, connectionlnfo, 
connectionHandle) 

Opens a connection to the PDE using either USB or UART interface. 


Parameter 

Description 

connectionType 

[IN] 

Type of connection to be opened, USB or UART 

connectionlnfo 

Information about the connection, includes items such as port#. 

[IN] 

baud rate, etc. 

connectionHandle 

A handle to the opened connection to be used with subsequent 
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[OUT] 


function calls 


3.2.4. CloseConnection (connectionHandle) 

Closes a previously opened connection to PDE. 


Parameter 

Description 

connectionHandle 

[in] 

A handle to the opened connection to be used with subsequent 
function calls 
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3.3. Display Control Functions 

The Display Control Functions enable the host application to control and configure the output display. 

3.3.1. SetOutputVideoState (state) 

This function enables or disables the output video. When the output video is disabled, the display is 
blanked. 


Parameter 

Description 

state [IN] 

ENABLED - Enable the output video 

DISABLED - Disable the output video and blank the display 


3.3.2. GetOutputVideoState (state) 

Returns the current state of the output video. 


Parameter 

Description 

state [OUT] 

ENABLED - The output video is enabled 

DISABLED - The output video is disabled 


3.3.3. SetBrightnessVal ( brightness, commit) 

Set the brightness for the output display. 


Parameter 

Description 

brightness [IN] 

Floating point value from 0.0 to 1.0 in 0.1 step 

commit [IN] 

0 - Do not Save (value restores back to original value after power 
cycle) 

1 - Save 


3.3.4. GetBrightnessVal ( brightness, type) 

Retrieve the current PDE brightness value. 


Parameter 

Description 

brightness 

Floating point value from 0.0 to 1.0 

[OUT] 


type [IN] 

0 - Current value 


1 - Value stored at initial PDE power up 


2 - Factory default 
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3.3.5. SetColorMode (colorMode, commit) 

The PDE includes red (640 nm), green (532 nm), blue (450 nm) laser light sources that illuminate the 
scanned beam projection display. The lasers enable the PDE to provide a wide gamut of brilliant and 
reproducible colors. This expanded color gamut is significantly larger than the standard NTSC gamut (see figure 
below). 


CIE v 1 



CIE 1976 u V Color Space 
(Radiant Imaging Color Chart) 


This function sets the PDE color mode. 


Parameter 

Description 

colorMode [IN] 

BRILLIANT - PicoP wide gamut color space 

STANDARD - standard NTSC color space 

INVERTED - inverted color space 

commit [IN] 

0 - Do not Save (value restores back to original value after power 
cycle) 

1 - Save 


3.3.6. GetColorMode (colorMode, type) 

This function retrieves the current color mode setting from the PDE. 
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Parameter 

Description 

colorMode [OUT] 

BRILLIANT - PicoP wide gamut color space 

STANDARD - standard NTSC color space 

INVERTED - inverted color space 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up 

2 - Factory default 


3.3.7. SetAspectRatio (aspectRatio, commit) 

This function allows the host to manipulate the aspect ratio of the projected image. 


Parameter 

Description 

aspectRatio 

[IN] 

NORMAL - Project input image centered with no scaling. 

848x480 content (16:9) will fill the projection area. 640x480 
content (4:3) will have blank regions on either side of the image 
(Pillarboxed). Other input sizes will be centered in the projection 
area. 


WIDESCREEN - Horizontally scale the input image from a 4:3 aspect 
ratioto 16:9 aspect ratio. Use this mode specifically to render 
anamorphically compressed widescreen content that is transmitted 
in a 4:3 format. No vertical scaling is applied. 


ZOOMJHORIZONTAL - Zoom To Fit Horizontally, retaining aspect 
ratio, cropping if necessary. 


ZOOM_VERTICAL - Zoom To Fit Vertically, retaining aspect ratio, 
cropping if necessary. 


ZOOM_ANAMORPHIC - Zoom To Fit Horizontally and Vertically, 
regardless of original aspect ratio. 

commit [IN] 

0 - Do not Save (value restores back to original value after power 


cycle) 


1 - Save 


This supported aspect ratio modes are illustrated below: 




NORMAL (4:3) 


WIDESCREEN (16:9) 
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ZOOM_HORIZONTAL 


ZOOM VERTICAL 


3.3.8. GetAspectRatio (aspectRatio, type) 

This function retrieves the current PDE aspect ratio setting. 


Parameter 

Description 

aspectRatio 

[OUT] 

NORMAL - Project input image centered with no scaling. 

848x480 content (16:9) will fill the projection area. 640x480 
content (4:3) will have blank regions on either side of the image 
(Pillarboxed). Other input sizes will be centered in the projection 
area. 


WIDESCREEN - Horizontally scale the input image from a 4:3 aspect 
ratioto 16:9 aspect ratio. Use this mode specifically to render 
anamorphically compressed widescreen content that is transmitted 
in a 4:3 format. No vertical scaling is applied. 


ZOOMJHORIZONTAL - Zoom To Fit Horizontally, retaining aspect 
ratio, cropping if necessary. 


ZOOM_VERTICAL - Zoom To Fit Vertically, retaining aspect ratio, 
cropping if necessary. 


ZOOM_ANAMORPHIC - Zoom To Fit Horizontally and Vertically, 
regardless of original aspect ratio. 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up. 

2 - Factory default 


3.3.9. SetGammaVal (color, gammaVal, commit) 

This function allows the host to manipulate the gamma setting of each primary color display. 


Parameter 


Description 

color [IN] 

RED 

- Set the gamma of the red laser 


GREEN 

- Set the gamma of the green laser 


BLUE 

- Set the gamma of the blue laser 


ALL 

- Set the gamma of all (red, blue and green) lasers 

gammaVal 

A floating point value for gamma 
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[IN] 


commit [IN] 

0 - Do not Save (value restores back to original value after power cycle) 

1 - Save 



Original Image 

Setting Gamma of ALL lasers 



Gamma =1.0 Gamma = 2.2 

Setting Gamma of RED Laser 



Gamma =1.0 


Gamma = 2.2 



Gamma of GREEN Laser 


Gamma =1.0 


Gamma = 



2.2 
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Setting Gamma of BLUE Laser 



Gamma =1.0 Gamma = 2.2 


3.3.10. GetGammaVal (color, gammaVal, type) 

This function retrieves the current display gamma value. 


Parameter 

Description 

color [IN] 

RED - Get the gamma of the red laser 

GREEN - Get the gamma of the green laser 

BLUE - Get the gamma of the blue laser 

gammaVal 

[OUT] 

Current gamma value 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up 

2 - Factory default 


3.3.11. Fliplmage (direction) 

This function allows the host to flip the rendered image horizontally or vertically. 


Parameter 

Description 

direction [IN] 

HORIZONTAL - image flip across the display horizontal axis 

VERTICAL - image flip across the display vertical axis 


The effect of the image flip is illustrated below: 
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3.3.12. CorrectKeystone ( keystoneCorrectionVal, commit) 

Keystone correction is a function that allows projectors that are not placed perpendicular to the 
horizontal centerline of the screen (too high or too low) to skew the output image, thereby making it 
rectangular. 

The CorrectKeystone() function allows a symmetrical keystone correction (the same amount of 
correction is applied to both left and right sides of the display). 


Parameter 

Description 

keystoneCorrectionVal 

[IN] 

Keystone correction value (range -100 ... +100) 

commit [IN] 

0 - Do not Save (value restores back to original value after power 
cycle) 

1 - Save 


The effect of the keystone correction is illustrated below: 
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Before Keystone correction 


After Keystone Correction 
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3.3.13. CorrectVerticalDistortion (angleDeviationLeft, 

angleDeviationRight, horizOffsetLeft, horizOffsetRight, commit) 

This function allows asymmetrical vertical distortion correction; i.e. different amount of correction 
is applied to the left and right side of the display. 


Parameter 

Description 

angleDeviationLeft [IN] 

Angle of deviation on the left hand side 

angleDeviationRight [IN] 

Angle of deviation on the right hand side 

horizOffsetLeft [IN] 

Horizontal offset on the left hand side 

horizOffsetRight [IN] 

Horizontal offset on the right hand side 

commit [IN] 

0 - Do not Save (value restores back to original value 
after power cycle) 


1 - Save 


The effect of the vertical distortion correction is illustrated below: 



Before Vertical Distortion Correction After Vertical Distortion Correction 

3.3.14. SetupWarp ( scrSize, destSize, commit) 

This function sets up the PDE Warp engine by providing the size of the source area to be warped 
and destination area to display the results. 
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Parameter 

Description 

scrSize [IN] 

Size (Width and Heigth) of the display source area 

destSize [IN] 

Size (Width and Heigth) of the display destination area 

commit [IN] 

0 - Do not Save (value restores back to original value after 


power cycle) 


1 - Save 


3.3.15. Warplmage (warpOperation, value, commit) 

This function allows the host device to apply warping operations to correct image distortions of 
the displayed image. Please Note that the Warplmage function does not operate at full 60Hz frame 
rate. During Warp operation the frame rate is slowed down to allow completion to the warp 
computations and memory accesses. 


Parameter 

Description 

warpOperation [IN] 

Type of distortion correction to apply: 

ROTATE 

SMILE 

PARALLELOGRAM 

STRETCH 

value [IN] 

Amount of Warp 

commit [IN] 

0 - Do not Save (value restores back to original value after 
power cycle) 

1 - Save 



Original Image 
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SMILE 



STRETCH 


3.3.16. SetColorConverter ( color, coefficient, commit) 

This function sets the color converter value for a specific color pair in the 3x3 color converter 
matrix. 


Parameter 

Description 

color [IN] 

RED_TO_RED - Red to Red 

GREEN_TO_RED - Green to Red 

BLUE_TO_RED - Blue to Red 

RED_TO_GREEN - Red to Green 

GREEN_TO_GREEN - Green to Green 

BLUE_TO_GREEN - Blue to Green 

RED_TO_BLUE - Red to Blue 

GREEN_TO_BLUE - Green to Blue 

BLUE TO BLUE - Blue to Blue 

coefficient [IN] 

Value for the color converter (Range -65536 ... +65535) 

commit [IN] 

0 - Do not Save (value restores back to original value after 
power cycle) 

1 - Save 
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The effect of the color converter setting is illustrated below: 



3.3.17. GetColorConverter ( color, offset, type ) 

This function returns the color converter value for a specific color pair in the 3x3 color converter 
matrix. 


Parameter 

Description 

color [IN] 

RED_TO_RED - Red to Red 

GREEN_TO_RED - Green to Red 

BLUE_TO_RED - Blue to Red 

RED_TO_GREEN - Red to Green 

GREEN_TO_GREEN - Green to Green 

BLUE_TO_GREEN - Blue to Green 

RED_TO_BLUE - Red to Blue 

GREEN_TO_BLUE - Green to Blue 

BLUE TO BLUE - Blue to Blue 

offset [OUT] 

Value for the color converter (Range -32768 ... +32767) 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up 

2 - Factory default 


3.3.18. SetPhase ( phaseOffset, commit) 

This function allows the host to manipulate the scan line phase delay to align the forward and 
reverse scan video. This phase setting is automatic and this manual override should not be needed in 
typical operation. 


Parameter 


Description 
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phaseOffset [IN] 

Value for the horizontal phase offset (Range -50 ... +50) 

commit [IN] 

0 - Do not Save (value restores back to original value after 
power cycle) 

1 - Save 


The effect of the Phase setting is illustrated below: 




Original Image 


Phase Offset = 30 


3.3.19. GetPhase ( phaseOffset, type) 

This function retrieves the scan line phase delay. 


Parameter 

Description 

phaseOffset [OUT] 

The current phase offset value 

type [IN] 

0 - Current value 


1 - Value stored at initial PDE power up 


2 - Factory default 


3.3.20. SetColorAlignment (direction, color, offset, commit) 

This function performs vertical or horizontal color alignment for the selected color component. 


Parameter 

Description 

direction [IN] 

HORIZONTAL - perform color alignment in Horizontal direction 

VERTICAL - perform color alignment in Vertical direction 

color [IN] 

RED - Align Red color component 

GREEN - Align Green color component 

BLUE - Align Blue color component 

offset [IN] 

Value for the alignment (Range -32 ... +32) 

commit [IN] 

0 - Do not Save (value restores back to original value after 
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power cycle) 

1 - Save 


The effect of the color alignment setting is illustrated below: 



Original Image 



direction = VERTICAL, color = RED, offset = 32 


3.3.21. GetColorAlignment (direction, color, offset, type) 

This function returns the alignment offset in vertical or horizontal direction for a color component. 


Parameter 

Description 

direction [IN] 

HORIZONTAL - color alignment in Horizontal direction 

VERTICAL - color alignment in Vertical direction 

color [IN] 

RED - Red color component 

GREEN - Green color component 

BLUE - Blue color component 

offset [OUT] 

Value for the alignment (Range -32 ... +32) 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up 

2 - Factory default 


3.3.22. AutoSetGreenMagentaBalance () 

This function performs automatic adjustment the green-magenta color balance. 
The effect of green-magenta balance is illustrated below: 
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Image before adjusting auto green magenta balance After adjusting auto green-magenta balance 


3.3.23. GetAutoGreenMagentaBalanceStatus () 

This function returns the status of the auto adjust command of the green-magenta color balance. 
Returns SUCCESS if the auto green-magenta balance was done successfully. Returns BUSY if the 
balance operation is still in progress. 


3.3.24. SetGreenMagentaBalance ( offset, commit) 

This function peforms manual adjustment of the green-magenta color balance. 


Parameter 

Description 

offset [IN] 

Value for the green-magenta color balance (Range -25 ... +25) 

commit [IN] 

0 - Do not Save (value restores back to original value after 
power cycle) 

1 - Save 


The effect of green-magenta balance is illustrated below: 




Image before adjusting green magenta balance After adjusting green magenta balance 

offset = +20 
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3.3.25. GetGreenMagentaBalance ( offset, type) 

This function returns the green-magenta color balance value. 


Parameter 

Description 

offset [OUT] 

Value for the green-magenta color balance (Range -25 ... +25) 

type [IN] 

0 - Current value 

1 - Value stored at initial PDE power up 

2 - Factory default 
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3.4. Input Control Functions 

The Input Control Functions allow the host device to control and configure the PDE video input interface. 


3.4.1. SetlnputVideoState (state) 

This function enables or disables the PDE input video interface. When the input video is disabled, the PDE 
frame buffer will not be updated and the output video will contain the last received frame. 


Parameter 

Description 

state [IN] 

ENABLED - Enable the input video 

DISABLED - Disable the input video and statically display the last 
received video frame contained in the frame buffer. 


3.4.2. GetlnputVideoState (state) 

Returns the current state of the input video. 


Parameter 

Description 

state [OUT] 

ENABLED - The input video is enabled 

DISABLED - The input video is disabled 


3.4.3. SetlnputCaptureModelnfo ( modeHandle, capturelnfo) 

This function configures a custom input video mode to be accepted by PDE. This new mode augments the 
built-in video modes already supported by the PDE. 


Parameter Description 


modeHandle [OUT] Returned handle to the added video capture mode 
capturelnfo [IN] Information on the video capture mode to be supported: 

Video clock polarity 
VSync Polarity 
HSync Polarity 
Horizontal Start Position 
Horizontal Resolution 
Vertical Start Position 
Vertical Resolution 
Color Space 
Interlace Type 
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3.4.4. GetlnputCaptureModelnfo ( modeHandle, capturelnfo) 

Returns the information stored for a specific video capture mode. 


Parameter Description 


modeHandle [IN]Handle to the video capture mode to be queried 
capturelnfo [OUT] Video capture mode information: 

Video clock polarity 
VSync Polarity 
HSync Polarity 
Horizontal Start Position 
Horizontal Resolution 
Vertical Start Position 
Vertical Resolution 
Color Space 
Interlace Type 


3.4.5. SetActiveCaptureMode (modeHandle) 

This function sets the input video capture mode to be used. The incoming video MUST match the 
parameters defined by the given mode to be displayed correctly. 


Parameter 

Description 

modeHandle [IN] 

Handle to the video capture mode to activate 


3.4.6. GetActiveCaptureMode (modeHandle) 

Returns the input video capture mode being used. 


Parameter 

Description 

modeHandle [OUT] 

Handle to the video capture mode being used 


3.4.7. GetlnputVideoProperties (frameRate, lines) 

This function returns the detected input video Frame Rate and Lines per Frame. This is a utility 
helper function that can be used by the application to help determine the input video format if it is not 
known. 
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Parameter 

Description 

frameRate [OUT] 

Detected number of video frames per second 

lines [OUT] 

Detected number of video lines per single video frame 
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3.5. Rendering Functions 

PDE has a set of commands which enables the host to transform the rendering operations. 

3.5.1. SetOSDState (state) 

This function enables or disables the PDE On-Screen Display (OSD). When enabled, the OSD window is 
overlaid on top of the output video. 


Parameter 

Description 

state [IN] 

ENABLED - Enable the OSD and have it overlaid on the displayed 
image 

DISABLED - Disable the OSD 



On-Screen Display Enabled 


3.5.2. GetOSDState (state) 

Returns the current state of the On-Screen Display (OSD). 


Parameter 

Description 

state [OUT] 

ENABLED - The OSD is enabled 

DISABLED - The OSD is disabled 


3.5.3. SetOSDInfo ( startPoint, size) 

This function sets the Position and Size of the On-Screen Display (OSD) within the output video area. 


Parameter 

Description 

startPoint [IN] 

(x,y) coordinates of the upper left corner location of the OSD 

size [IN] 

Size (width, height) of the OSD 
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startPoint(x,y) 



Position and size of the On-Screen Display 


3.5.4. GetOSDInfo (startPoint, size) 

Returns the Position and Size of the On-Screen Display (OSD). 


Parameter 

Description 

startPoint [OUT] 

(x,y) coordinates of the upper left corner location of the OSD 

size [OUT] 

Size (width, height) of the OSD 


3.5.5. GetDisplaylnfo (renderTarget, size) 

Returns the current size of the Frame Buffer. 


Parameter 

Description 

renderTarget [IN] 

Frame Buffer used for rendering 

size [OUT] 

Size (width, height) of the OSD 


3.5.6. SetActiveFrameBuffer (renderTarget) 

Sets the active frame buffer to be used for video output. 


Parameter 

Description 

renderTarget [IN] 

Frame Buffer used for rendering 


3.5.7. GetActiveFrameBuffer (renderTarget) 

Returns the active frame buffer to be used for video output. 


Parameter 


Description 
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renderTarget [OUT] 


Frame Buffer currently used for rendering 


3.5.8. LoadBitmapImage (target, startPoint, dimensions, imageBuf, 
bufLength) 

This function loads raw binary RGB565 encoded bitmap image (.bmp) into the OSD or a Framebuffer. 


Parameter 

Description 

target [IN] 

Frame Buffer to be used for loading the image 

startPoint [IN] 

(x,y) coordinates of the upper left corner location of the 
image placement in Frame Buffer 

dimensions [IN] 

Size (width, height) of the displayed image 

imageBuf [IN] 

Data of bitmap image (24bit RBG, Windows BMP) 

bufLength [IN] 

Length of the image data stream 




startPoint(x,y) 



target 


height 


width 


Position and size of rendered bitmap 
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3.5.9. DrawTestPattern (target, startPoint, dimensions, patternColor, 
backgroundColor, pattern) 

Internal test patterns are stored inside the PDE memory. This function allows the host to display internal 
test patterns. 


Parameter 

Description 

target [IN] 

Frame Buffer to be used for loading the image 

startPoint [IN] 

(x,y) coordinates of the upper left corner location of the test 
pattern 

dimensions [IN] 

Size (width, height) of the displayed test pattern 

patternColor [IN] 

24-bit RGB Color Value for the test pattern 

backgroundColor[IN] 

24-bit RGB Color Value for the test pattern background 

pattern [IN] 

0-4x4 Checkerboard 

1-32 Horizontal grayscale ramp 

2 - Splash screen 

3- 16x12 grid (1 pixel wide) 

4- Cross hair (1 pixel wide) 

5 - Solid (constant) white 

6 - Solid (constant) black 

7-32 Vertical grayscale ramp 
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Various built-in test patterns are illustrated below: 

While the test pattern display is activated, the PDE will ignore any external video input. To 
resume external video display the SetlnputVideoState () function must be called. 



4x4 Checkerboard (RED laser ON) Splash screen (All lasers ON) 



32 Vertical grayscale ramp (GREEN) Solid black 


Solid White (ALL) 
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3.5.10. DrawText (target, text, length, location, color) 

This function queues a command to display Text in the OSD or FrameBuffer. 


Parameter 

Description 

target [IN] 

Target to render to (Frame Buffer # or OSD) 

text [IN] 

Text to draw 

length [IN] 

Length of the text (in # of characters) 

startPoint [IN] 

Starting position for the text (lower-left corner) 

color [IN] 

24-bit RGB Color value for the text 


3.5.11. GetTextBoxInfo (text, length, textBoxRegion ) 

This function returns the dimensions of the bounds of the rectangular region that would be filled with the 
given text (but not actually drawn). This will provide the API user with feedback to determine where to draw 
text, how to determine line-breaks, how to dimension menu items, etc. 


Parameter 

Description 

text [IN] 

Text to draw 

length [IN] 

Length of the text (in # of characters) 

textBoxRegion 

[OUT] 

Region that would be filled with the given text if rendered 


3.5.12. DrawPoint (target, pixel, color) 

This function queues a command to set a single pixel into the OSD or a FrameBuffer. The queued up draw 
commands can be executed with the RenderQ function. 


Parameter 

Description 

target [IN] 

Target to render to (Frame Buffer # or OSD) 

pixel [IN] 

(x,y) coordinates of the pixel to turn on 

color [IN] 

24-bit RGB Color Value for the pixel 
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3.5.13. DrawLine (target, point A, pointB, color) 

This function queues a command to draw a single pixel wide line into the OSD or a FrameBuffer. The 
queued up draw commands can be executed with the RenderQ function. 


Parameter 

Description 

target [IN] 

Target to render to (Frame Buffer # or OSD) 

pointA [IN] 

(x,y) coordinates of the starting point of the line 

pointB [IN] 

(x,y) coordinates of the ending point of the line 

color [IN] 

24-bit RGB Color Value for the line 


pointA(x,y) 



3.5.14. DrawTriangle (target, point A, pointB, pointC, fillColor) 

This function queues a command to draw a triangle into the OSD or a FrameBuffer. The triangle will be 
filled with color. To draw a triangle outline, please draw 3 lines. The queued up draw commands can be 
executed with the RenderQ function. 


Parameter 

Description 

target [IN] 

Target to render (Frame Buffer # or OSD) 

pointA [IN] 

(x,y) coordinates of the first corner of the triangle 
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pointB [IN] 

(x,y) coordinates of the second corner of the triangle 

pointC [IN] 

(x,y) coordinates of the third corner of the triangle 

fillColor [IN] 

24-bit RGB Color Value fill value for the triangle 


pointA(x,y) 



3.5.15. DrawRectangle (target, startPoint, size, fillColor) 

This function queues a command to set a single pixel in the OSD or a FrameBuffer. The queued up draw 
commands can be executed with the renderQ function. 


Parameter 

Description 

target [IN] 

Target to render (Frame Buffer # or OSD) 

startPoint [IN] 

(x,y) coordinates of the upper left corner of the rectangle 

size [IN] 

Size (width, height) of the rectangle 

fillColor [IN] 

24-bit RGB Color Value fill value for the rectangle 



3.5.16. Render (target) 

Renders queued draw commands into a Render Target. The number of rendering commands that can be 
queued is limited by the memory available in the PDE. Once the memory is full, any additional draw command 
will fail and the queued commands should be completed with the RenderQ command. Please note that rendering 
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into a Frame Buffer that is actively capturing input video will result in the rendered pixels to be overwritten by 
input video. 


Parameter 

Description 

target [IN] 

Target to render (Frame Buffer # or OSD) 
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3.6. System Management Functions 

The System management functions enable the host application to query system status as health. 

3.6.1. GetSystemStatus (systemStatus) 

PDE allows the user to know the status of the PDE system, whether it is working properly or not. 


Parameter 


Description 


systemStatus [OUT] 


Returned system status structure with the following 

information: 

Status: 0 - system OK, < >0 System not OK 
If bit 0 set: laser fault 
If bit 1 set: laser fault 
If bit 2 set: laser fault 
If bit 3 set: laser fault 
If bit 4 set: laser fault 
If bit 5 set: laser fault 
If bit 8 set: MEMS fault 
If bit 12 set: system fault 
If bit 13 set:UI fault 
If bit 14:video fault 
If bit 15:video fault 
If bit 16:USB fault 
If bit 17:USB fault 
If bit 19:auto phase fault 
If bit 20:warp fault 

bit 6, 7, 9, 10, 11, 18, 21-31:reserved for future use 


State: Current system state, e.g ready to accept video. 

PDE Temperature 

Data 0 for future expansion 

Data 1 for future expansion 

Data 2 for future expansion 

Data 3 for future expansion 

Data 4 for future expansion 
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3.6.2. GetSystemlnfo (systemlnfo) 

This function allows the host to retrieve information about the PDE system which includes System Serial 
Number, Software Version Number and ASIC Version Numbers. This information can be used for 
troubleshooting and configuration management. 


Parameter 


Description 


systemlnfo [OUT] 


Returned system information structure with the following 
information: 

PDE System Serial Number 
PDE Software Version 
PDE Electronics Version 
PDE Runtime 

Data 0 for future expansion 
Data 1 for future expansion 
Data 2 for future expansion 
Data 3 for future expansion 


3.6.3. GetEventLog ( numEvents, events) 

PDE maintains a log of system events that have occurred. The host can retrieve the event log information of 
last events with the GetEventLogO function. This function is typically used for system troubleshooting. 


Parameter 

Description 

numEvents 

[IN] 

Number of events to be retrieved 

Events [OUT] 

Returned events, list of event data structures 


3.6.4. SetSystemPowerState (state) 

This function sets the PDE system power state. 


Parameter 

Description 

state [IN] 

Set the system to one of the following power states: 


RUNNING - System Running 


STANDBY - System Standby 


SHUTDOWN - System Shutdown 
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3.6.5. GetSystemPowerState (state) 

This function returns the current PDE system power state. 


Parameter 

Description 

state [OUT] 

The current PDE power state: 


RUNNING - System Running 


STANDBY - System Standby 


SHUTDOWN - System Shutdown 


3.6.6. RestoreFactoryConfig (commit) 

This function restores the PDE system configuration to the factory configuration. 


Parameter 

Description 

commit [IN] 

0 - Do not Save (value restores back to original value after power 
cycle) 

1 - Save 


3.6.7. SaveSplashScreen (target) 

This function takes a snapshot of the specified frame buffer and saves the content as the Splash Screen. 


Parameter 

Description 

target [IN] 

The frame buffer to take snapshot of. 


3.6.8. UpgradeSoftware (image, size) 

The PDE supports upgrading the embedded software of the system with the UpgradeSoftwareQ function. 


Parameter 

Description 

image [IN] 

Data of the SW binary 

size [IN] 

Size of the SW binary 
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